home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 26 / Cream of the Crop 26.iso / bbs / txmail21.zip / TXMAILER.DOC < prev    next >
Text File  |  1997-05-17  |  17KB  |  351 lines
  1.  
  2.                                                         ▄▄     ▄▄
  3.            ▀▀▀▀█▀▀▀▀ █▀▀▀▀▀▀▄ ▄▀▀▀▀▀▀▄ █▄     █ █▀▀▀▀▀▀  ▀█▄ ▄█▀
  4.                █     █▀▀▀▀▀▀▄ █▀▀▀▀▀▀█ █ ▀▀▄▄ █ ▀▀▀▀▀▀█    ▐█▌
  5.                █     █      █ █      █ █     ▀█ ▄▄▄▄▄▄█  ▄█▀ ▀█▄
  6.                                                        ▄█▀     ▀▀
  7.                                                      ▄█▀  Mailer
  8.            Internet/Fidonet Transporter            ▄█▀
  9.        Copyrighted Multiboard Communications Centre, 1995-1997
  10.            All rights reserved                 ▄█▀
  11.                                              ▄█▀
  12.  
  13. ╓────────────────────────────────────────────────────────────────────────────╖
  14. ║  Introduction                                                              ║
  15. ╙────────────────────────────────────────────────────────────────────────────╜
  16.  
  17.    What is it?
  18.  
  19.      ■ TxMAILER is a package that will use SMTP and POP3 to send and
  20.        retrieve TransX mail bundles from your standard email account.
  21.  
  22.      ■ TxMAILER is only designed to be used with TransX v1.1 or higher
  23.        and does not function as a stand-alone package.
  24.  
  25.    How does it work?
  26.  
  27.      ■ What it does is dial your Internet provider over a PPP link and
  28.        once connected sends your outbound TransX bundles with SMTP
  29.        then scans your POP3 mailbox for any TransX mail.  If it finds
  30.        any, it will save them to disk for TransX to process and remove
  31.        them from your mailbox.
  32.  
  33.      ■ If you normally use this same mailbox for your personal mail and
  34.        download it with something like Eudora(r), Microsoft Exchange(r)
  35.        or Microsoft Mail/News(r) you will need to take precaution to make
  36.        sure that mail for TransX is not deleted from your mailbox when you
  37.        transfer mail from your host to your machine.  Some of the readers
  38.        mentioned above will allow you to specify whether mail should
  39.        automatically be deleted from your mailbox.  If not you must always
  40.        run TxMAILER before downloading your mail otherwise your regular
  41.        mail client will download all the mail and delete it from the
  42.        mailbox, including the TransX mail rendering TxMAILER useless.
  43.  
  44.      ■ An optimal solution would be to ask your Internet provider if you
  45.        can have a secondary mailbox.  Most providers will do this for
  46.        free or for a very nominal charge.  Get your second mailbox named
  47.        something like "userid-tx", in my case "rocca-tx" this would
  48.        become your robot name in TransX, as well as your mailbox name.
  49.        Then all of the TransX mail could be sent and received from
  50.        "userid-tx@yourisp.com" leaving your personal mailbox untouched
  51.        by TransX or TxMAILER.
  52.  
  53.    How much work is it to run and maintain?
  54.  
  55.      ■ Once setup, this send and receive transfer process is fully
  56.        automated and runs from a batch file which is automatically
  57.        created each time you run TXBUILD.EXE
  58.  
  59.  
  60. ╓───────────────────────────────────────────────────────────────────────────╖
  61. ║ Installing                                                                ║
  62. ╙───────────────────────────────────────────────────────────────────────────╜
  63.  
  64.    Installing TxMAILER couldn't be simpler.
  65.  
  66.     1) Simply extract the archived package into the SAME directory
  67.        you have TransX installed into. (if you have not yet installed
  68.        TransX you will need to before installing TxMAILER)
  69.  
  70.     2) Run TXSETUP.EXE (from your original TransX installation)
  71.  
  72.        Configure TransX to use SMTP as the Advanced Spool Type.
  73.        Also specify the SMTP In and Out directories.
  74.  
  75.        ┌──┤ Advanced Options ├──────────────────────────┐
  76.        │                                                │
  77.        │  Advanced spool                                │
  78.        │   └ Type     : SMTP (In/Out)                   │
  79.        │                                                │
  80.        │  SMTP options                                  │
  81.        │   ├ SMTP In  : M:\TRANSX\SMTP\IN\              │
  82.        │   ├ SMTP Out : M:\TRANSX\SMTP\OUT\             │
  83.        │   └ Time zone: -0500                           │
  84.        │                                                │
  85.        └────────────────────────────────────────────────┘
  86.  
  87.        Please note that the In and Out directories MUST be different
  88.        from each other, otherwise you will lose mail packets.
  89.  
  90.        You'll also need to configure your General Information to
  91.        reflect your PPP setup.
  92.  
  93.        ┌──┤ General Information ├─────────────────────────┐
  94.        │                                                  │
  95.        │  Sysop         : Joe User                   (a)  │
  96.        │  System name   : Joe's BBS System           (b)  │
  97.        │  Domain        : yourisp.com                (c)  │
  98.        │  Site address  : 1:999/9238                 (d)  │
  99.        │  Gate address  : 0:0/0                      (e)  │
  100.        │  Gate netflags : Kill/Direct                (f)  │
  101.        │  Robot name    : transx                     (g)  │
  102.        │                                                  │
  103.        └──────────────────────────────────────────────────┘
  104.  
  105.        (a) Your name
  106.        (b) Your BBS name
  107.        (c) Your providers domain name
  108.        (d) Your main Fidonet style address
  109.        (e) 0:0/0
  110.        (f) Kill/Direct
  111.        (g) Your mailbox name (usually)
  112.  
  113.            For example if your email address is fred@site.com
  114.            then "fred" would be your robot name and "site.com"
  115.            would be your domain.
  116.  
  117.     3) Edit the LOGIN.CMD script file to log you on your Internet
  118.        provider.  The commands that are available are as follows:
  119.  
  120.        START                - The script begins with this line
  121.        DEBUG ON             - You can turn on display debugging
  122.        HANGUP               - Attempt to hangup
  123.        SEND <string>        - Sends the 'string' to the modem
  124.        SEND                 - Sends a CR/LF to the modem
  125.        WAIT <time> <string> - Waits up to 'time' seconds for 'string'
  126.        WAIT <time>          - Waits 'time' seconds
  127.        PRINT <string>       - Displays 'string' to the console
  128.        END                  - Signal that the script was successful
  129.  
  130.        There is a sample LOGIN.CMD file included.
  131.  
  132.     4) Run TXBUILD.EXE, and fill in the required information.  There is
  133.        also online help available by pressing "F1".  Each time this program
  134.        exits, it will create/update the TXFULL.BAT file which is what you
  135.        will need to run in order to handle all of the processing.
  136.  
  137.  
  138. ╓───────────────────────────────────────────────────────────────────────────╖
  139. ║ Running                                                                   ║
  140. ╙───────────────────────────────────────────────────────────────────────────╜
  141.  
  142.    Now you just run TXFULL.BAT to transfer your mail whenever needed.
  143.    This batch file will:
  144.  
  145.      * Make sure that all the required files exist
  146.      * Make sure that all the drivers are loaded
  147.      * Export your TransX mail
  148.      * Dial your Internet provider
  149.      * Transfer the mail
  150.      * Unload the installed drivers
  151.      * Hang up
  152.      * Import any TransX mail received
  153.  
  154.  
  155. ╓────────────────────────────────────────────────────────────────────────────╖
  156. ║  Common Questions and Answers                                              ║
  157. ╙────────────────────────────────────────────────────────────────────────────╜
  158.  
  159.    First of all, thanks for reading this section!
  160.  
  161.    Q) The mail gets downloaded from my provider ok, and I see it sitting
  162.       in the inbound SMTP directory I have defined, but TransX just
  163.       ignores it?
  164.    A) This is often caused by having the incorrect domain address for
  165.       your provider.  Many providers have their 'root' domain, for
  166.       example "site.com", but email addresses are on another domain
  167.       for example "galaxy.site.com".  You can find out for sure by
  168.       turning on DEBUG logging in TXSETUP, then when you run TransX
  169.       you should see something like:
  170.  
  171.       = Opening at 15 Jun 96  09:50:38
  172.       & 0 routing entries
  173.       & Skip; to userid-tx@storm.site.com (SMTP), from ...
  174.       = Closing at 15 Jun 96  09:50:38
  175.  
  176.       In this case, the domain name is "storm.site.com", and the
  177.       robot name should be "userid-tx"
  178.  
  179.       In addition if your robot name in TXSETUP does not match the one
  180.       being sent to then your mail will also not be imported.
  181.  
  182.    Q) I can only get one mailbox from my provider, will TxMAILER
  183.       delete my non-TransX mail?
  184.    A) TransX will only download mail that has "Receipt" or "Transport"
  185.       as the subject line.  There is a chance that other mail could
  186.       have these subject lines.  If this is a heavy concern, you should
  187.       seek out another provider who can offer you a second mailbox.
  188.  
  189.    Q) It's not initializing my modem?
  190.    A) Try reducing the baud rate to 38400.
  191.  
  192.    Q) It crashes my machine when hanging up?
  193.    A) Try using the fossil driver support.
  194.  
  195.    Q) TxMAILER says it can't resolve <name>?
  196.    A) Make sure that your Gateway, Netmask and Name Server entries
  197.       are correct in TxBUILD.  If you are unsure of what the values
  198.       should be, then please contact your Internet provider for the
  199.       correct addresses.  If that still does not work trying changing
  200.       the Netmask value in TxBUILD to 0.0.0.0
  201.  
  202.    Q) I keep getting an error message saying <something> but can't
  203.       get past it?
  204.    A) Please send us a copy of your log file and the TXDEBUG.LOG and
  205.       we will try to get it solved as quickly as possible.
  206.  
  207.    Q) It says that my POP3 username/password is invalid but I know it's
  208.       the right password.
  209.    A) Make sure that you have not included the domain name after the
  210.       POP3 account name.  For example with user@yoursite.com your POP3
  211.       name would probably be "user" not "user@yoursite.com"
  212.  
  213.  
  214. ╓───────────────────────────────────────────────────────────────────────────╖
  215. ║ Support                                                                   ║
  216. ╙───────────────────────────────────────────────────────────────────────────╜
  217.  
  218.    If you have any questions or comments, you can netmail us at FidoNet
  219.    address 1:2401/305 (CM,V34,VFC).  Please poll back for your replies
  220.    as we get dozens of messages a day or optionally make a note that you
  221.    would like your message routed back to you.  You can also contact us
  222.    via the Internet for faster responses, and directly sent out replies.
  223.    The address is "support@multiboard.com"  Also please look at our
  224.    TxMailer tech support site at http://www.multiboard.com/txhelp.html
  225.  
  226.    You can also find us in the RA_UTIL echo conference, as well as the
  227.    MCC_SUPPORT echo of course.
  228.  
  229.    The newest MCC software is also available via the Internet:
  230.  
  231.    http://www.multiboard.com/
  232.    ftp://ftp.multiboard.com/
  233.  
  234.    You can also "FREQ" the files from us via FidoNet at 1:2401/305
  235.    Our system is online and taking requests 24 hours/day
  236.    The magic name for the newest version of TransX is "TRANSX"
  237.    The magic name for the newest version of TxMAILER is "TXMAILER"
  238.    Freq "CATALOG" for the newest list of our other products.
  239.  
  240.    You can help us direct your messages by using the alternative email
  241.    addresses when posting us mail:
  242.  
  243.     (1)  support@multiboard.com      -  general inquiries
  244.     (2)  sales@multiboard.com        -  registrations/commercial info
  245.     (3)  suggestions@multiboard.com  -  suggestions
  246.     (4)  reports@multiboard.com      -  bug reports
  247.  
  248.    Thanks for your interest and support!
  249.  
  250.  
  251. ╓───────────────────────────────────────────────────────────────────────────╖
  252. ║ Changes                                                                   ║
  253. ╙───────────────────────────────────────────────────────────────────────────╜
  254.  
  255.   v1.0 - First release
  256.  
  257.   v1.1 - Made some small changes to the dialing package
  258.  
  259.        - Fixed a bug that would cause it to not be able to
  260.          detect the IP address in SLIP mode if your provider
  261.          used a particular type of IP notification message
  262.  
  263.        - Fixed a bug that could cause a lockup while trying to
  264.          send the encoded messages
  265.  
  266.   v1.2 - Puts the TXMAILER.LOG file in the same directory as
  267.          you have specified for the TX.LOG file.
  268.  
  269.        - If your IP address in TxBUILD is not set to 0.0.0.0 it
  270.          no longer tries to find a dynamic IP address
  271.  
  272.        - If there is a file called BETWEEN.BAT in the current directory
  273.          then TxMAILER will run it (memory permitting) after checking
  274.          the POP3 mailbox.  When it returns it will send any new mail
  275.          waiting to go out.  The purpose of this is to allow you to
  276.          call up, receive new mail, run TransX while still online and
  277.          send out any receipts you may have created for the mail you
  278.          just received.
  279.  
  280.        - Added a command line parameter /NUKEALL, this will remove
  281.          all mail from your mailbox, TransX or not.  Any mail not
  282.          to TransX will be saved as nnn.@@@ in your inbound SMTP
  283.          directory.  Use with caution.
  284.  
  285.   v1.3 - Recognizes the x.x.x.x. (with trailing period or comma)
  286.          as a valid IP number.
  287.  
  288.        - Accepts a 220 response to a HELO command (the SMTP host
  289.          did not accept our handshake error message)
  290.  
  291.        - Fixes the omission of the GOTO :END label in the batch file
  292.  
  293.        - Allows for an /IP=x.x.x.x on the command line to set IP
  294.  
  295.  
  296.  
  297. ╓───────────────────────────────────────────────────────────────────────────╖
  298. ║ License and Disclaimer                                                    ║
  299. ╙───────────────────────────────────────────────────────────────────────────╜
  300.  
  301.    TxMAILER is FREE, provided you have registered or bought a commercial
  302.    copy of "TransX".  If you are using the unregistered shareware version
  303.    of TransX, then you have fourteen (14) days to evaluate TxMAILER.
  304.  
  305.    TransX is being marketed under the "try before you buy" or the shareware
  306.    concept.  You are entitled to use TransX for a period up to thirty (30)
  307.    days, after which you MUST register or stop using the program.
  308.  
  309.    Registration will also you to use all of the available functions of
  310.    TransX, and help to continue the development of this program.  (not
  311.    to mention maintain the legality of this agreement)
  312.  
  313.    By running any of the executable programs included, you agree that
  314.    Pete Rocca, Darryl Olthoff, Multiboard Communications Centre nor any
  315.    affiliates of the above mentioned are responsible for any damage or
  316.    loss experienced, however so created.  If you cannot agree to this,
  317.    then your privilege to use any of these programs is revoked and it
  318.    becomes illegal for you to execute any programs included with this
  319.    documentation.
  320.  
  321.    You may freely copy and distribute the shareware version of TransX as
  322.    long as its original archived contents are not modified in any way.
  323.    You may NOT distribute any registration keys without the expressed
  324.    written consent of Pete Rocca of Multiboard Communications Centre.
  325.    You may not use a registration key that is not licensed to you by
  326.    Pete Rocca, or any of the registration sites appointed by Pete Rocca.
  327.  
  328.    It is illegal to edit, alter, hack, reverse engineer and / or modify
  329.    any components of TransX or its archive components in any manner.
  330.  
  331.    TransX and its encoding and security algorithms are the legal
  332.    property of Multiboard Communications Centre.  They may not be used
  333.    in any other program other than TransX without the express written
  334.    consent of Pete Rocca of Multiboard Communications Centre.
  335.  
  336.    This product, concept and design are protected by Canadian copyright
  337.    laws and international treaty provisions.  If dispute of any issues
  338.    on legal grounds said above, then governing law of Ontario, Canada
  339.    will rule.  If you agree to all of the above, then you may use
  340.    these programs.
  341.  
  342.    * REMEMBER THAT REGISTRATION IS QUITE INEXPENSIVE FOR ALL YOU SAVE *
  343.  
  344.    The TCP/IP stack of this product was developed with the WATTCP TCP/IP
  345.    library routines copyright (c) 1990-1993 Erick Engelke.  The TxMAILER
  346.    package is also bundled with the PPPD packet driver courtesy of
  347.    and copyrighted by Antonio Lopez Molero.
  348.  
  349.    Eudora(r), Microsoft Mail/News(r) and Microsoft Exchange(r) are owned,
  350.    copyrighted and/or trademarked by their respective companies.
  351.